home *** CD-ROM | disk | FTP | other *** search
/ Win Platinum / Win Platinum.iso / apps / msgmstr / msgmstr.doc < prev    next >
Encoding:
Text File  |  1991-04-18  |  42.7 KB  |  1,049 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                                     Message Master
  31.                                         v1.00
  32.  
  33.                                           by
  34.                                  William Schlichtman
  35.                           Sysop of FidoNet(tm) node 1:350/59
  36.                                     April 15, 1991
  37.  
  38.                          Copyright 1991, William Schlichtman.
  39.                                  All rights reserved.
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.           Message Master v1.00                                       Page 2
  48.           Reference Manual
  49.  
  50.           Acknowledgments
  51.  
  52.           I wish to thank the Message Master Alpha-Beta Test Team for their
  53.           enthusiastic and tireless  efforts.  Their  time, hard work,  and
  54.           suggestions  have  made  Message  Master  an  outstanding,  solid
  55.           product that I'm sure you will enjoy.
  56.  
  57.           I wish to give special thanks to Hubert Lai  for his never-ending
  58.           bashing  of my  programming efforts  which kept  me glued  to the
  59.           screen for  a solid week (my wife would like  to get her hands on
  60.           him too).  His  help in the design  of many of the user  features
  61.           has contributed much to the overall feel of Message Master.
  62.  
  63.           Straight, and to the point:-), Allan Bazinet's fine work deserves
  64.           high praise and I wish to express my sincere thanks for the extra
  65.           effort.  Without his insight, point addressing in Message  Master
  66.           would be virtually non-existent.
  67.  
  68.           Both of these gentlemen are, without a doubt, two of  the kind we
  69.           need more of in FidoNet.
  70.  
  71.           Introduction
  72.  
  73.           Message  Master (MsgMstr)  was developed  out of  the need  for a
  74.           good,  clean FidoNet message  reader for  Microsoft's Windows(tm)
  75.           environment,  and  also  to  provide  experience  in  Windows(tm)
  76.           programming for your's  truly.  I think  you will agree  that (at
  77.           least the first point) the objectives have been attained.
  78.  
  79.           MsgMstr  is a  message editor  in the  traditional sense  in that
  80.           there are two main  modes of operation  -- Read Message and  Edit
  81.           Message modes.   To edit messages,  you MUST be in  an edit mode.
  82.           Trying  to edit text without  entering the edit  mode is allowed,
  83.           but there is  no way to save the file unless in the edit mode and
  84.           all edited  text will lost.   You will know  when you are  in the
  85.           edit message  mode by  the display  of the  Quick-Access buttons.
  86.           While  in the edit mode, only three  of the buttons are active --
  87.           namely the Cancel, Save, and Append buttons, which  are explained
  88.           below.
  89.  
  90.           MsgMstr is not only a message  reader and editor, it is a message
  91.           maintenance system in itself.  Some features include Quick-Access
  92.           editing buttons; reply and quoting features; easy one-step access
  93.           to  file  requests,  update  requests and  file  attach  options;
  94.           convenient  default attribute  feature; quick,  easy installation
  95.           (esp. if  you use  BinkleyTerm); 'standard' keyboard  action keys
  96.           remanent of Msged and OpMed; fast-action, single stroke access to
  97.           most  message menu  functions;  manually 'launch'  your  favorite
  98.           mailer; and much  more.   Features will continually  be added  to
  99.           future versions and the system refined, as your needs become more
  100.           apparent.
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.           Message Master v1.00                                       Page 3
  109.           Reference Manual
  110.  
  111.           What MsgMstr  is not  is a  DOS program.   This  has a  couple of
  112.           aspects worth mentioning.   First,  Windows(tm) applications  are
  113.           notoriously slower than DOS  applications.  I believe most  of us
  114.           understand why,  so I  will not  dwell  on that  problem.   Every
  115.           attempt  has been made to make MsgMstr as responsive as possible.
  116.           Certain  routines were  written in  such a  manner as  to prevent
  117.           unwarranted delays in  placing information on  the screen.   This
  118.           causes  other problems, but a  happy medium needed  to be reached
  119.           and I believe my implementations to be satisfactory.
  120.  
  121.           Secondly,  DOS has (normally) one  way of showing  text -- 80x25.
  122.           Windows(tm) is different.  It is  graphical and has a much varied
  123.           user interface.  MsgMstr was developed on a  system with SVGA and
  124.           using a 800x600  video driver.  This is a  wonderful mode and one
  125.           that affords  access  to large  amounts of  information onto  the
  126.           screen.   Unfortunately, it is not the  'standard' mode installed
  127.           with  Windows(tm), if  there is  a 'standard'  mode.   Usually, a
  128.           lower  resolution is  installed  which, to  my  way of  thinking,
  129.           limits  a user  in  this graphical  world  of ours.   MsgMstr  is
  130.           written to accommodate all video drivers, as it should be.   But,
  131.           if  you do have higher display capabilities than VGA, I recommend
  132.           to investigate them.  They may be  worth it.  (Don't let it scare
  133.           you when you first try it.   The information will seem soooo tiny
  134.           at first, but after you get accustomed to the look, you'll wonder
  135.           how you got along without it.)
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.           Message Master v1.00                                       Page 4
  144.           Reference Manual
  145.  
  146.           Shareware Notice
  147.  
  148.           This software is  not free and  is not released  into the  public
  149.           domain.   This  is shareware,  a 'try  before you  buy' marketing
  150.           method.    The  software you  are  now  using,  MsgMstr, must  be
  151.           purchased  after a short evaluation period - that period being 30
  152.           days from the time you begin using it.  If  you feel this product
  153.           benefits you,  and you  intend to  use it past  the 30  day trial
  154.           period, you must send $35.00 to:
  155.  
  156.                William Schlichtman
  157.                5644 Marion Hill Rd. SE
  158.                Turner, OR.  97392-9745
  159.  
  160.           If you do not intend to use this product, you must  erase it from
  161.           your storage media  unless you are a System Operator (SYSOP) of a
  162.           form  of electronic  bulletin  board system  and  intend to  help
  163.           distribute  MsgMstr.   If  you are  a SYSOP  and place  this file
  164.           'online'  for download,  it  must be  in  its complete  form  and
  165.           include all files in the original distribution package.  Namely:
  166.  
  167.                MsgMstr.Exe    The program
  168.                MsgMstr.Doc    The docs
  169.  
  170.           Please adhere to these  guidelines as this product is  the result
  171.           of MANY hours  of work and the author is  poor, needs the income,
  172.           has teenage children  who have not eaten  in 2 months,  and needs
  173.           money for  the brain tumor  that has  been running rampant  for 6
  174.           months.
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.           Message Master v1.00                                       Page 5
  183.           Reference Manual
  184.  
  185.           Setup
  186.  
  187.           Installation  of MsgMstr is  simple.  Place  the MsgMstr.Exe file
  188.           into  any directory.  If  you are using  BinkleyTerm, then ensure
  189.           the 'BINKLEY' environment variable is set to Bink's directory and
  190.           a copy of AREAS.BBS is  in the same directory (if you  have one).
  191.           Install MsgMstr into a group window of your choice.  Double click
  192.           the MsgMstr icon and away you go.
  193.  
  194.           MsgMstr will search for  the environment variable 'BINKLEY' first
  195.           to establish the default path for the files it uses for automatic
  196.           setup.  If  not found, it will search for  the file 'BINKLEY.CFG'
  197.           in the directories listed in  your PATH statement.  If still  not
  198.           found, then the  current directory is  used as a default  for the
  199.           files needed.
  200.  
  201.           MsgMstr will also locate  and utilize the 'Application' parameter
  202.           if placed  in the Binkley.Cfg  file.  MsgMstr  currently supports
  203.           only  one  variation of  the Application  parameter.   The format
  204.           necessary is:
  205.  
  206.                Application MsgMstr Area <type>,<title>,<path>
  207.  
  208.           where <type>  is  either 'L',  'E',  or 'P'  for Local,  Echo  or
  209.           PassThru area respectively.   <title> is used in the  same manner
  210.           as an  Echo name but  may be more  than one word  if the  line is
  211.           flagged a type  'L'.  The <path>  indicates the full  pathname to
  212.           the message area.  Here is an example:
  213.  
  214.                Application MsgMstr Area L,Opus Meadow,E:\Msgs\Meadow
  215.                Application MsgMstr Area E,CHAFF,E:\Msgs\Net\
  216.  
  217.           MsgMstr  is pretty forgiving in the format  of these lines.  Case
  218.           is not important although I usually use caps for echo areas and a
  219.           mix for local  areas in the <title> parameter;   the paths may or
  220.           may not end with  a backslash, depending on your  preference; and
  221.           there may be leading spaces in each field which will be removed.
  222.           See BinkleyTerm's documentation for a complete description of the
  223.           Application parameter.
  224.  
  225.           One note of caution.  You should not list your echos  in both the
  226.           Areas.Bbs  file and  Binkley.Cfg.   Although  no problems  should
  227.           occur,  both would  be listed  as separate  areas when  using the
  228.           editor.
  229.  
  230.           For  those  not running  BinkleyTerm,  or if  MsgMstr  can't find
  231.           anything it's looking for during the previously stated procedure,
  232.           you will need  to fill in the  setup window upon start  up.  Once
  233.           completed, all  necessary files  will be  created in the  default
  234.           directory.  Note that only Echo  areas should be filled in during
  235.           the setup routine  when asked.  This  is because these files  are
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.           Message Master v1.00                                       Page 6
  244.           Reference Manual
  245.  
  246.           added to Areas.Bbs, not Binkley.Cfg.   You will need to add local
  247.           areas to the Binkley.Cfg file manually using the format above.
  248.  
  249.           Be aware that a file called 'MSGMSTR.INI' will be created in your
  250.           Windows(tm) directory and contains  some system setup and default
  251.           information.  You should be able to determine each line's purpose
  252.           by inspection  but Appendix  B  of this  document describes  each
  253.           entry in its entirety.  Make changes to this file only if you are
  254.           sure what  you are doing.   The paths to the  files necessary for
  255.           startup are placed in this file.
  256.  
  257.           As  you can see, MsgMstr  is quite flexible  in it's requirements
  258.           for configuration information and  should provide you with enough
  259.           latitude to get your system just the way you want it.
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.           Message Master v1.00                                       Page 7
  268.           Reference Manual
  269.  
  270.           Operation
  271.  
  272.           MsgMstr  operates as most  other Windows(tm) programs  -- using a
  273.           combination  of keyboard, mouse, and  menu commands.  Buttons and
  274.           simple  keystrokes are provided for  common actions.   Below is a
  275.           list of  options  activated either  by menu-selection  or by  the
  276.           Quick-Access buttons on  MsgMstr's main display,  or both.   Note
  277.           also  that many  menu  selections are  provided with  fast-action
  278.           keystrokes, single stroke key presses that avoid clicking through
  279.           the menus.
  280.  
  281.           The format  of the section titles  provided below is to  list the
  282.           main menu selection first, followed by the sub-menu title.  Means
  283.           of  access  is indicated  in  parenthesis  following the  section
  284.           names.   'M' indicates it  may be accessed  from the menu's,  'Q'
  285.           means  a  Quick-Access  button  is  provided,  and  'K'  states a
  286.           keystroke is provided.  Note that normal Windows keystrokes (such
  287.           as the Edit Menu shortcuts and access to the menu) are not listed
  288.           below, only those that are of special significance.  For standard
  289.           Windows(tm) keystrokes, refer to your Windows(tm) manual.
  290.  
  291.           A  special note pertaining to button operation of the main reader
  292.           display:   The 'Enter' key will operate the last button selected.
  293.           If you have just used the 'Next' button, pressing the 'Enter' key
  294.           will operate the 'Next' button again.
  295.  
  296.           Files - Save MSG (M)
  297.  
  298.           This menu item  saves the  current message as  a formatted  ASCII
  299.           text  file.   All  header and  message  text  is written  to  the
  300.           selected file using the  current default options concerning EID's
  301.           and SEEN-BY lines.
  302.  
  303.           This  option provides  the user  a way  to transport  messages to
  304.           other, less-capable (non-Windows, non-FidoNet) machines.
  305.  
  306.           Files - Save MSG Text (M)
  307.  
  308.           This menu  item is  similar to  'Save MSG'  except that  only the
  309.           message body is written to the selected file.
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.           Message Master v1.00                                       Page 8
  318.           Reference Manual
  319.  
  320.           Files - Rescan Message Areas (M)
  321.  
  322.           Allows the  user to rescan all message  areas and update the list
  323.           of messages that have new mail in them.  This  option is normally
  324.           not  necessary because  MsgMstr does  a quick  area scan  as it's
  325.           entering a new area, but it is provided for your convenience.
  326.  
  327.           Services - Print Message (MK)
  328.  
  329.           Sends  the current message to  the printer.   This selection uses
  330.           the Windows' interface so you must have Print Manager available. 
  331.           Press 'P' to activate this option from the keyboard.
  332.  
  333.           Files - Set Water Marks (MK)
  334.  
  335.           Allows the mail  processor to rescan  message areas by  resetting
  336.           the so-called  water marks,  marks that  are  identified by  most
  337.           mailers as to  whether messages have been  scanned or not.   This
  338.           allows  for faster processing by  the mailer and  affords you the
  339.           opportunity to select messages to be rescanned, and mailed again.
  340.           MsgMstr  affords  access to  both high  and  low water  marks and
  341.           displays pertinent information about current settings.  Press 'W'
  342.           to active this option from the keyboard.
  343.            
  344.           Files - Exit (MK)
  345.  
  346.           Allows  you  to exit  MsgMstr. You  will  not be  prompted before
  347.           exiting  using this  option from  the menu,  but if  you use  the
  348.           ESCAPE  key command,  you  have a  second  chance before  exiting
  349.           MsgMstr.   Press the ESCAPE key  to activate this option from the
  350.           keyboard.
  351.  
  352.           Files - About (M)
  353.  
  354.           Displays version and copyright information.
  355.  
  356.           Edit - Undo (MK)
  357.  
  358.           Reverses the previous editing command.
  359.  
  360.           Edit - Cut (MK)
  361.  
  362.           Removes the selected text and places it into the Clipboard.
  363.  
  364.           Edit - Copy (MK)
  365.  
  366.           Places a copy of the selected text into the Clipboard.
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.           Message Master v1.00                                       Page 9
  375.           Reference Manual
  376.  
  377.           Edit - Paste (MK)
  378.  
  379.           Places  the  contents of  the  Clipboard  at  the current  cursor
  380.           location.
  381.  
  382.           Edit - Clear (MK)
  383.  
  384.           Deletes the selected text without placing it into the Clipboard.
  385.  
  386.           Edit - Append Text File (MQK)
  387.  
  388.           This is a quick way to append an ASCII  text file into a message.
  389.           The  appended file is  added to the end  of the message currently
  390.           being edited.   This command  is unavailable unless  in the  edit
  391.           mode.    To merge  text, use  the  Clipboard. Press  CONTROL+A to
  392.           activate this option from the keyboard.
  393.  
  394.           Edit - Cancel (MQK)
  395.  
  396.           Cancels the  edit session without  saving the edited  message and
  397.           returns to  the previous message in the message read mode.  Press
  398.           CONTROL+C to activate this option from the keyboard.
  399.  
  400.           Edit - Save (MQK)
  401.  
  402.           Saves  the message  currently  being edited  and  returns to  the
  403.           previous  message in the message  read mode.   Press CONTROL+S to
  404.           activate this option from the keyboard.
  405.  
  406.           Edit - Select All (MK)
  407.  
  408.           Selects all text in the body of the message.
  409.  
  410.           Edit - Edit header (M)
  411.  
  412.           Allows the user to change the current message header information.
  413.           You may activate  this option  by double-clicking  on the  header
  414.           information window.
  415.  
  416.           Message - Jump to Message (MK)
  417.  
  418.           Prompts  the user for a message number, then locates and displays
  419.           the message  or the message nearest the location desired.  If the
  420.           desired message is not  found and if the desired message is lower
  421.           than the current  message, the next lowest  message is displayed.
  422.           The  reverse  is  true for  a  selection  high  than the  current
  423.           message.  Press 'J' to activate this option from the keyboard.
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.           Message Master v1.00                                      Page 10
  432.           Reference Manual
  433.  
  434.           Message - Next Message (MQK)
  435.  
  436.           Selects  the next message number higher than the current message.
  437.           If the current message  is the highest message in  the area, then
  438.           nothing happens. The 'Right Arrow' key may be used to select this
  439.           option from the keyboard.
  440.  
  441.           Message - Previous Message (MQK)
  442.  
  443.           Selects the next message  number lower than the  current message.
  444.           If the current message  is the lowest message  in the area,  then
  445.           nothing happens.  The 'Left Arrow' key may be used to select this
  446.           option from the keyboard.
  447.  
  448.           Message - Thread Forward (MQK)
  449.  
  450.           Selects the next message in the  current thread.  To determine if
  451.           there  are other  messages  in a  thread,  an indicator  will  be
  452.           displayed  in the header information. The  'F' key may be used to
  453.           select this option from the keyboard.
  454.  
  455.           Message - Thread Back (MQK)
  456.  
  457.           Selects the previous message in the current thread.   The 'B' key
  458.           may be used to select this option from the keyboard.
  459.  
  460.           Message - New Message (MQK)
  461.  
  462.           Allows the user to enter a  new message.  The current user's name
  463.           and address  will be  filled in automatically.   Default  message
  464.           attribute  settings  will  be  selected.    Information  for  the
  465.           addressee must be filled in  or the session will abort.   Message
  466.           attributes may be changed as necessary.  Once all required header
  467.           information  is supplied,  the  user  is  prompted to  enter  the
  468.           message body.   The  Quick-Access buttons  will  change to  allow
  469.           saving the  message or aborting the session.   Other buttons  and
  470.           menu items become  non-functional until  the session  ends.   All
  471.           editing functions  are activated  as available until  the session
  472.           ends.  Press 'N' to activate this option from the keyboard.
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.           Message Master v1.00                                      Page 11
  481.           Reference Manual
  482.  
  483.           Message - Reply (MQK)
  484.  
  485.           Allows the user  to reply to  the current message.   The  current
  486.           user's name  and address  will be  filled in automatically  along
  487.           with  the  addressee's name  and  address  information.   Default
  488.           message attribute settings will  be selected.  Message attributes
  489.           may  be   changed  as  necessary.    Once   all  required  header
  490.           information  is  supplied,  the user  is  prompted  to  enter the
  491.           message  body.   The Quick-Access  buttons will  change to  allow
  492.           saving the message or aborting the session.  Other buttons become
  493.           non-functional until the session ends.  All editing functions are
  494.           activated  as available  until the  session ends.   Press  'R' to
  495.           activate this option from the keyboard.
  496.  
  497.           Message - Quote (MQK)
  498.  
  499.           Allows the user  to reply to the current message  and inserts the
  500.           text from  the current  message into  the new  message, formatted
  501.           with  current  FidoNet standards.   The  current user's  name and
  502.           address  will   be  filled   in  automatically  along   with  the
  503.           addressee's  name  and  address  information.    Default  message
  504.           attribute  settings will be selected.   Message attributes may be
  505.           changed as  necessary.  Once  all required header  information is
  506.           supplied, the user is prompted to enter the message body.  Quoted
  507.           material should  be edited to include  only pertinent information
  508.           relevant  to the response.   ALL OTHER QUOTED  MATERIAL SHOULD BE
  509.           DELETED.   The Quick-Access buttons  will change to  allow saving
  510.           the message or aborting  the session.  Other buttons  become non-
  511.           functional until  the session ends.   All  editing functions  are
  512.           activated  as available  until the  session ends.   Press  'Q' to
  513.           activate this option from the keyboard.
  514.  
  515.           Message - Store (MQK)
  516.  
  517.           Saves a duplicate copy of the current message to a special, user-
  518.           selected  storage  area that  should  not  be scanned  by  mailer
  519.           software.  This area  is to afford the user with a safe place for
  520.           those messages that are felt to  be too important to lose.  Press
  521.           'S' to activate this option from the keyboard.
  522.  
  523.           Message - Edit (MK)
  524.  
  525.           Allows the current message text to be edited and saved.  The user
  526.           is placed  in a mode similar  to the Enter Message  mode, but the
  527.           message, if saved, will overwrite the current message.  No header
  528.           info  is changed.   Press 'E'  to activate  this option  from the
  529.           keyboard.
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.           Message Master v1.00                                      Page 12
  538.           Reference Manual
  539.  
  540.           Message - Delete (MQK)
  541.  
  542.           Deletes  the current  message.   A  warning message  is displayed
  543.           prior  to deletion for that last-chance some of us need at 02:00.
  544.           Press 'D' to activate this option from the keyboard.
  545.  
  546.           Message - Move (MK)
  547.  
  548.           Allows  the user to move  the current message  to another message
  549.           area.  Press 'M' to activate this option from the keyboard.
  550.  
  551.           Message - Forward (M)
  552.  
  553.           Provides  a  method to  resend  the  current message  to  another
  554.           addressee.
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.           Message Master v1.00                                      Page 13
  563.           Reference Manual
  564.  
  565.           Message - Copy (MK)
  566.  
  567.           Allows  the  user to  make  an identical  copy  of a  message and
  568.           forward it to another user.  Press 'C' to activate this option.
  569.  
  570.           Change Area (MK)
  571.  
  572.           Pops up  a list of message areas to choose from.  These areas are
  573.           all areas listed in  the AREAS.BBS file obtained during  start up
  574.           and  all   areas  found   in  'Application'  parameters   in  the
  575.           Binkley.Cfg file.   Another called  'MATRIX' is listed,  which is
  576.           the  system's  netfile area.   MATRIX  is  the area  that MsgMstr
  577.           always starts  up in and is  listed first.  Also,  an area called
  578.           'STORAGE' is listed.   This area holds messages you  'Store' with
  579.           the 'store'  option.  See Message - Store.  Press 'A' to activate
  580.           this option from the keyboard.
  581.  
  582.           Any item  preceded by an asterisk '*' is an area with new, unread
  583.           messages.  'New'  messages are  determined  by  the last  message
  584.           pointer maintained in each message area.
  585.  
  586.           List Messages (MK)
  587.  
  588.           Pops  up  a  list of  header  information  for,  at most,  twenty
  589.           messages  at one  time.   Controls to  move about  throughout the
  590.           messages in  the area  are placed  at the top  of the  screen and
  591.           allow the user to page through; jump to the end, beginning, or in
  592.           the  middle; select a message; or abort selection.  Highlight the
  593.           desired item and  select the OK button or hit  the return key, or
  594.           double-click  on the item to display  that message.  Press 'L' to
  595.           activate this option from the keyboard.
  596.  
  597.           Services - Default Attributes (M)
  598.  
  599.           Pops up a screen affording  a myriad of options available to  the
  600.           user.   Current  defaults  are either  checked  or filled-in,  as
  601.           appropriate.   Any  selection  is possible  except where  options
  602.           would be mutually exclusive,  such as crash/hold mail.   The user
  603.           may abort settings or  write them to MSGMSTR.INI by  selection of
  604.           the appropriate OK/CANCEL button.
  605.  
  606.           The Quote Information Line  is a special, formatted line  that is
  607.           used along with the Add Quote Info checkbox.  If  the checkbox is
  608.           selected, the text in  the Quote Information Line will  be placed
  609.           prior to  quoted text when  saving a  quoted message.   An ending
  610.           separator  line is  also  attached  at  the  end  of  the  quoted
  611.           material.
  612.  
  613.           The special  format of  the Quoted  Information Line consists  of
  614.           four special characters, namely:
  615.                %s %d %d %s
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.           Message Master v1.00                                      Page 14
  624.           Reference Manual
  625.  
  626.           and must be placed anywhere in the text line in  the order shown.
  627.           They may be separated by any  text you wish to place between them
  628.           ,but  they  must exist.    The purpose  of  the characters  is to
  629.           provide  a placeholder for system information you may want in the
  630.           quote line.   Each character has a meaning and  will be filled in
  631.           as such:
  632.  
  633.                %s   The first  %s will  be replaced  by  a three  character
  634.                     string depicting the current month.
  635.                %d   The first %d character will be  replaced by the current
  636.                     day number.
  637.                %d   The second %d will be replaced by the current year, all
  638.                     four digits.
  639.                %s   The second %s will be replaced by the sysop's name.
  640.  
  641.           This option allows  for some flexibility in what can be placed on
  642.           the line without  too much complexity.  A default  string will be
  643.           placed in the Origin Information Line edit  box as an example and
  644.           is the standard by which most message editors go.
  645.  
  646.           NOTE:     Changing the default path names can place the system in
  647.                     an  unknown  state.   Ensure  you are  correct  in your
  648.                     settings when changing these options.
  649.  
  650.           Services - Node Information (M)
  651.  
  652.           Displays what is known of the system.
  653.  
  654.           Services - Launch Mailer (M)
  655.  
  656.           Starts  up you favorite mail  processor, such as  QMail, to allow
  657.           instant  mail  handling.    The  command  line  option  presented
  658.           defaults, of course, to the command the author uses.  Notice that
  659.           a batch file  is used.  This allows for  maximum flexibility when
  660.           calling you procedure, but  is not required.  Ensure  the command
  661.           line you  enter can  be performed  from your  directory location.
  662.           Otherwise the  system will  return to MsgMstr  without performing
  663.           the desired operation.
  664.  
  665.           If you  intend to run a  DOS application such as  QMail from this
  666.           command, you may  wish to run  it using a  .PIF file.  This  will
  667.           allow the  routine to run in  the background if you  choose to do
  668.           so.   
  669.  
  670.           The Default  Attributes dialog box  contains an edit  window that
  671.           allows you to  reset the default  setting.  You  must set a  full
  672.           pathname,  including  filespec  and  extension,  along  with  any
  673.           parameters you  may wish to  pass.  If using  a .PIF to  run this
  674.           option, no parameters are passed to the program.
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.           Message Master v1.00                                      Page 15
  683.           Reference Manual
  684.  
  685.           NOTE:     This  option  has the  capability  of  doing more  than
  686.                     launching your mailer.  Use it as you deem necessary.
  687.  
  688.           A couple  of  items  worth mentioning  that  do not  fit  in  the
  689.           preceding notes:
  690.  
  691.           First, MsgMstr will search for a file  called ORIGIN in each echo
  692.           area  when adding  origin lines.   If  found, the  default Origin
  693.           Information Line will be replaced by the text string contained in
  694.           this file.   The text string may be  of any length, but  only the
  695.           first 63  characters on  the first  line will  be displayed.   No
  696.           carriage  return should  precede the  text  and the  system's net
  697.           address will be appended to it in the message.
  698.  
  699.           Second, normally  Windows displays  characters in what  is called
  700.           the  ANSI character mode.  Other text-based message editors use a
  701.           similar,  but  slightly  different mode  called  OEM  mode.   The
  702.           differences  are significant normally  only when characters above
  703.           7F  hexidecimal  are  used  but other  times,  when  proportional
  704.           characters are being displayed for instance, certain displays may
  705.           be  affected also.   If  you believe  something  is amiss  on the
  706.           display, try switching to the OEM mode  to see if that may be the
  707.           problem.   To switch, you  may use the  Default Attributes dialog
  708.           box, which  will be recorded to the default data file, or you may
  709.           use the 'V' toggle key, which only affects the current session.
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.           Message Master v1.00                                      Page 16
  718.           Reference Manual
  719.  
  720.           APPENDIX A
  721.  
  722.           Reader Main Display Keystrokes
  723.  
  724.           Right Arrow..............Displays the next message
  725.           Left Arrow...............Displays the previous message
  726.           Up Arrow.................Scrolls the message body up one line
  727.           Down Arrow...............Scrolls the message body down one line
  728.           PageUp...................Scrolls the message body up a page
  729.           PageDown.................Scrolls the message body down a page
  730.           Home.....................Jumps to first message in an area
  731.           End......................Jumps to last message in an area
  732.           Escape...................Exits MsgMstr (prompted first)
  733.           A or a...................Change message areas
  734.           B or b...................Displays the previous thread message
  735.           C or c...................Copies the current message
  736.           D or d...................Deletes the current message
  737.           E or e...................Edit the current message
  738.           F or f...................Displays the next message in a thread
  739.           J or j...................Jump to any message number
  740.           L or l...................List header information for the messages
  741.           M or m...................Move the current message
  742.           N or n...................Enter a new message
  743.           P or p...................Print the current message
  744.           Q or q...................Enter a quoted reply to the current msg
  745.           R or r...................Enter a reply to the current msg
  746.           S or s...................Stores the current message
  747.           V or v...................Toggles OEM/System Font video modes
  748.           W or w...................Set water marks
  749.           Z or z...................Zips you back to the last message viewed
  750.  
  751.           Edit Mode Control Keys
  752.  
  753.           Control+A................Appends a file to the edited message
  754.           Control+C................Cancels the edit mode
  755.           Control+S................Saves the message being edited
  756.  
  757.           NOTE:     The Alt-keys function normally to operate the main menu
  758.                     in both  modes.  Normal editing  function selections in
  759.                     the Edit Menu only operate during Edit Mode.
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.           Message Master v1.00                                      Page 17
  768.           Reference Manual
  769.  
  770.           APPENDIX B
  771.  
  772.           Message Master Configuration Variables
  773.  
  774.           MESSAGE DISPLAY FLAGS
  775.           ---------------------
  776.  
  777.           QInitials
  778.                Flags  whether initials will be  placed on a  quoted line in
  779.                front of the '>' character.  The sysop's first and last name
  780.                initials are used.
  781.  
  782.           EID
  783.                Flags whether EID,  message editor ID, lines  will be shown.
  784.                Many  message  editors  implant  these lines  to  allow  for
  785.                identification of the editor and message threading.  MsgMstr
  786.                currently does not use or create this field.
  787.  
  788.           SeenBy
  789.                Flags whether  SEEN-BY lines will  be shown.   Seen-by lines
  790.                are  placed in messages by mailers and are used to determine
  791.                message routes and to prevent duplication.  MsgMstr does not
  792.                use or add this data.
  793.  
  794.           AddOrigLine
  795.                Flags whether an Origin Line will  be placed at the end of a
  796.                message that is  enter using MsgMstr.  This line is a little
  797.                tag that displays the system name and its FidoNet address.
  798.  
  799.           AddTearLine
  800.                Flags  whether a  Tear Line  will be  appended to  a message
  801.                entered  in MsgMstr.   This  line displays  Message Master's
  802.                short name 'MsgMstr' and the version number.
  803.  
  804.           ShowMsgPath
  805.                Flags  whether PATH lines will be displayed.  PATH lines are
  806.                another  form  of SEEN-BY  line but  shows the  actual route
  807.                through the FidoNet system.  Not all mailers use or add this
  808.                information, so  it may not be  a good indicator of  where a
  809.                message has really travelled.
  810.  
  811.           UseOEM
  812.                Flags  whether OEM  video display mode  is to be  used.  OEM
  813.                mode displays text-based  characters vice the graphics-based
  814.                system normally used by Windows(tm).   This mode is provided
  815.                to display messages containing special characters from a DOS
  816.                based message editor.
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.           Message Master v1.00                                      Page 18
  825.           Reference Manual
  826.  
  827.           AddQLine
  828.                Flags  whether to  add  a Quote  Information  Line (QIL)  to
  829.                messages.   The QIL is  a short statement  pertaining to the
  830.                original   message  being  quoted.     It  contains  special
  831.                formatting  requirements, explained  in  the MsgMstr  User's
  832.                Manual and below.
  833.  
  834.  
  835.           MESSAGE ATTRIBUTE FLAGS
  836.           -----------------------
  837.  
  838.           Private
  839.                Flags messages as  private so that  only the addressee,  and
  840.                sysops of a node,  may read it.  Should not  be set for echo
  841.                areas.  That is considered a no-no.
  842.  
  843.           KillSent
  844.                Flags a message as Kill-When-Sent so that it will be deleted
  845.                after the mail processor has processed it.
  846.  
  847.           Crash
  848.                Flags a message  as continuous (crash) mail which tells your
  849.                mailer to send it immediately if allowed.
  850.  
  851.           Hold
  852.                Flags a  message as hold  mail so that  the mailer will  not
  853.                send it.
  854.  
  855.           FileAttach
  856.                Flags a message as a  file attach.  The file in  the subject
  857.                line  will be sent to the listed  node.  This option is only
  858.                available in the Matrix area.
  859.  
  860.           Sent
  861.                Flags a message as sent  so that the mailer will not  resend
  862.                it.
  863.  
  864.           InTransit
  865.                Flags a  message as In Transit  so that it passes  through a
  866.                system.  Fairly useless, but provided.
  867.  
  868.           ReqConfirm
  869.                Flags  a  message  as   Request  Confirmation  so  that  the
  870.                addressee's system will send a response that the message was
  871.                received.  Most systems do not support this option, but it's
  872.                here if you need it.
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.           Message Master v1.00                                      Page 19
  881.           Reference Manual
  882.  
  883.           Update
  884.                Flags a message as an  Update Request which is similar to  a
  885.                File Request, but  only transmits the requested file  if the
  886.                one requested is newer than the one currently on the calling
  887.                system.
  888.  
  889.           Freq
  890.                Flags a  message as a  File Request and means  what it says.
  891.                The message will request  the file(s) that is(are) contained
  892.                in the subject line.
  893.  
  894.  
  895.           FILE PATHS AND PATHNAMES
  896.           ------------------------
  897.  
  898.           NetMailPath
  899.                Path to  the Netmail (MATRIX) directory,  the directory that
  900.                holds all netmail.
  901.  
  902.           NodeListPath
  903.                Path  to the Nodelist directory which must contain a version
  904.                6 nodelist.
  905.  
  906.           EchoOutPath
  907.                Pathname to the Echomail  Outbound file.  The full  path and
  908.                filespec is contained here.
  909.  
  910.           AreasBBSPath
  911.                Path to Areas.Bbs, the echomail configuration file.
  912.  
  913.           BinkleyPath
  914.                Path to Binkley.Cfg, the BinkleyTerm configuration file.
  915.  
  916.           NetFilesPath
  917.                Path to  the Network  Files directory, where  incoming files
  918.                are stored until processed by the system mail processor.
  919.  
  920.           FileStoragePath
  921.                Path  to the Storage Area directory, where messages that are
  922.                'STORED' are placed.   This  area is normally  not, and  not
  923.                recommended to be, processed by mailers.
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.           Message Master v1.00                                      Page 20
  932.           Reference Manual
  933.  
  934.           SYSTEM CONFIGURATION PARAMETERS
  935.           -------------------------------
  936.  
  937.           SystemOperator
  938.                Sysops name
  939.  
  940.           SystemName
  941.                Name of the System
  942.  
  943.           SystemAddress
  944.                Full address  of the system  including zone,  net, node  and
  945.                point number. The format is standard: 
  946.                          zone:net/node.point
  947.  
  948.           BossAddress
  949.                Full  address of the boss node including zone, net, node and
  950.                point  number.  This  is only  present  when  the  system is
  951.                identified as a point.  The format is standard: 
  952.                          zone:net/node.point
  953.  
  954.           ShowPassThru
  955.                Flags  whether to display PASSTHRU  areas in the Change Area
  956.                option.  These areas  are determined by a '#'  preceding the
  957.                path in Areas.Bbs, the area called PASSTHRU in the Areas.Bbs
  958.                file,  and   by  the   'P'  parameter  in   the  Binkley.Cfg
  959.                Application statement.
  960.  
  961.           KeepLastReadUpdated
  962.                Flags  whether to  update  the LASTREAD  file anytime  a new
  963.                message is accessed.  This option slows performance somewhat
  964.                and is not recommended.  If not set, the LASTREAD file  will
  965.                be  updated  only  when  changing  areas  and  when  exiting
  966.                MsgMstr.    Note  that  this  pointer  is   not  updated  if
  967.                Windows(tm) is terminated while MsgMstr is still open, hence
  968.                the continuous option.
  969.  
  970.           QuoteLine
  971.                Contains  the Quote  Information Line  (QIL)  format string.
  972.                See MsgMstr User's Manual and below for correct formatting.
  973.  
  974.           MsgMstrX
  975.                Contains the main window's upper left x-axis coordinate.
  976.  
  977.           MsgMstrY
  978.                Contains the main window's upper left y-axis coordinate.
  979.  
  980.           MsgMstrH
  981.                Contains the main window's width.
  982.  
  983.           MsgMstrW
  984.                Contains the main window's height.
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.           Message Master v1.00                                      Page 21
  993.           Reference Manual
  994.  
  995.  
  996.           Flags will be either =1 for ON or =0 for OFF
  997.           Paths must contain a trailing backslash
  998.  
  999.           QuoteLine must contain four formatting characters, namely:
  1000.                %s %d %d %s
  1001.           in that order.  They may be anywhere in the  Quote Info line, but
  1002.           they must be present and in the order presented.
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.           Message Master v1.00                                      Page 22
  1011.           Reference Manual
  1012.  
  1013.           APPENDIX C
  1014.  
  1015.           Known Bugs:
  1016.  
  1017.           1)   In  standard  VGA  and  lesser  modes,  the  date  text  may
  1018.                overwrite some of the  address information.  This is  due to
  1019.                the length  of addressing  information and its  overlap into
  1020.                the date field.  A remedy is being worked  on that hopefully
  1021.                will be satisfactory.
  1022.  
  1023.           2)   The print function is limited and does not print the way I'd
  1024.                like  it to.    It may  print erratically  at  times.   This
  1025.                problem is being resolved.
  1026.  
  1027.           3)   Currently,   no  physical   manipulation  method   has  been
  1028.                installed for the  OEM toggle, such as a button or menu item
  1029.                (other than  the Default Attribute dialog box).  The problem
  1030.                is finding a suitable place for it.
  1031.  
  1032.           4)   Because Windows(tm) uses Shift  and Control keys as toggles,
  1033.                some keyboard functions may not appear to work at times.  If
  1034.                you find this to be so, try hitting the Shift or Control key
  1035.                prior  to hitting the desired keystroke.  You should get the
  1036.                desired result.  This problem is being worked out.
  1037.  
  1038.           Planned Features:
  1039.  
  1040.           1)   Addition  of  a  text search  routine.    This will  include
  1041.                options  to search  for  text in  header and/or  the message
  1042.                body.
  1043.  
  1044.           2)   Beef up  the  Message Forwarding  capabilities and  allowing
  1045.                area changes.
  1046.  
  1047.           3)   Add mass mailing capabilities.
  1048.  
  1049.